home *** CD-ROM | disk | FTP | other *** search
/ JCSM Shareware Collection 1993 November / JCSM Shareware Collection - 1993-11.iso / cl820 / jsreport.lzh / JSREPORT.TXT < prev    next >
Encoding:
Text File  |  1993-06-04  |  5.4 KB  |  176 lines
  1. JSREPORT Utility Program Documentation
  2. (Ver 1.1, 07-01-93)
  3.  
  4. Author: Johnathan Mark Smith
  5.  
  6.  
  7. THE OLD DISCLAIMER
  8.  
  9.   This software and manual are sold "as is" and without warranties
  10.   as to performance or merchant ability or any other warranties
  11.   whether expressed or implied. Because of the various hardware and
  12.   software environments into which this program may be put, no
  13.   warranty of fitness for a particular purpose is offered.
  14.  
  15.   The user must assume the entire risk of using and evaluating this
  16.   program. Any liability of  Johnathan Mark Smith Technology will be
  17.   limited exclusively to product replacement or refund of purchase
  18.   price. If you find these terms unacceptable, do not use this
  19.   product.
  20.  
  21. Introduction
  22.  
  23.  
  24.     Programmers are frequently asked to extract, format and print
  25. data for the PC.  It is not enough for the programmer simply to 
  26. pull off the records of interest to the user.  Usually, the records must be
  27. formatted to create a quick and easy report.  In a typical company, 
  28. hundreds of man-hours are spent each year in creating the small 
  29. ad-hoc programs required to generate such data.
  30.  
  31.  The JSREPORT utility greatly simplifies the task of manipulating
  32.  data for use in a PC environment.  JSREPORT provides the following
  33.  features:
  34.  
  35.  1.  Selective extraction of fields from an input record
  36.  
  37.  
  38.  2.  Selectable column position ordering of extracted fields.
  39.  
  40.  
  41.  3.  Ability to write the same input data into multiple output
  42.      fields.
  43.  
  44.  4.  Ability to make quick reports.
  45.  
  46.  
  47.  
  48.     The JSREPORT program must be provided with control information 
  49. to govern its execution. This information is read from a control file. 
  50. The control file is a standard PC text file that can be created 
  51. with any ASCII text editor.
  52.  
  53.  
  54.  The first line of the control file identifies the input file name.
  55.  
  56.  Subsequent lines of the file provide field extraction control information.
  57.  Each field exaction control line contains the name of the column 
  58.  to print the data in, the starting byte position of the field and 
  59.  the length of the field.
  60.  
  61. After entering all your fields if you want to bypass a number of records just
  62. add the word "BYPASS=n" on one of the control file lines.
  63.  
  64. If you want to set maximum number of records to print just add the 
  65. word "MAX=n" on one of the control file lines.
  66.  
  67. To set up the number of lines to print per page add the word "PAGELINES=n"
  68. on one of the control file lines.
  69.  
  70.  
  71.   * * n = THE NUMBER YOU WANT TO ENTER * *
  72.  
  73. The following sample control file illustrates how control 
  74. information is provided to the JSREPORT program.
  75.  
  76. Contents of a sample JSREPORT control file, JSREPORT.CTL:
  77.  
  78. C:\DATA\STC.TXT
  79. com1,2,4
  80. com2,10,1
  81. BYPASS=10
  82. MAX=100
  83. PAGELINES=50
  84.  
  85. The input file name is C:\DATA\STC.TXT.
  86.  
  87. The first field is com1 and the data starts in byte 2 of the input file
  88. and the field length is 4
  89.  
  90. the next field is com2 and the data starts in byte 10 of the input file
  91. and the field length is 1
  92.  
  93. The line "BYPASS=10" tells the utility to bypass the first ten records on 
  94. the input file.
  95.  
  96. The line "MAX=100" tells the utility not to print more then 100 records.
  97.  
  98. The line "PAGELINES=50" tells the utility to put 50 records on a page.
  99.  
  100.  
  101.  
  102. Registration
  103.  
  104.   I will keep improving the program if I know enough people are
  105.   finding it useful.
  106.  
  107.   My registration policy is very flexible. The nominal fee is $25 US
  108.   If you don't feel you will get $25 worth of use out of JSREPORT, send
  109.   whatever it is worth to you. If you are impoverished and can't
  110.   afford to pay anything, enclose a stamped self-addressed envelope
  111.   and I will send you a registration.
  112.  
  113.   This is not freeware or public domain. Shareware is simply a means
  114.   of marketing commercial software. You are required to register if
  115.   you intend to use this program after a reasonable trial period.
  116.  
  117.   When registering, please tell me the version number you have 
  118.   and where you obtained your copy of JSREPORT.
  119.  
  120.   See REGISTER.TXT for details.
  121.  
  122.   JSREPORT should be registered for the maximum number of copies that
  123.   can be used simultaneously at your site. Site fees for commercial
  124.   users can be negotiated.
  125.  
  126.   If you register for the full $25 fee, and enclose a Shipping and
  127.   Handling fee of $3 I will send you the latest versions of JSREPORT and
  128.   Some Free Demo's.  if you decide to use it after a trial period. I will 
  129.   also send other File related shareware programs.
  130.  
  131.  
  132. Registered version features
  133.  
  134. * FREE UPGRADES AND NEWSLETTERS
  135.  
  136. * CUSTOM DEFAULT SETTINGS
  137.  
  138.  
  139. Program Abort
  140.  
  141.     Hitting Control-C (or Control-Break) will terminate the program
  142.     immediately. 
  143.  
  144.  
  145. Distribution
  146.  
  147.     Permission is hereby given to copy and distribute this program
  148.     as long as no more than $5 is charged. It must be made clear to
  149.     the buyer that this is only a handling charge and not a
  150.     registration fee. You must include all files in their original
  151.     unmodified form when distributing this program. .
  152.  
  153.     Permission to distribute may be revoked by the Johnathan Mark Smith 
  154.     at any time for any reason.
  155.  
  156.     YOU MUST NOT DISTRIBUTE ANY COPY WHICH HAS BEEN BRANDED WITH
  157.     A REGISTRATION CODE. 
  158.  
  159. All trademarks used in this document are the property of their
  160. owners.
  161.  
  162.         -Johnathan Mark Smith-
  163.  
  164.  
  165. Questions or suggestions regarding JSREPORT should be directed to the author
  166. at the following address:
  167.  
  168.     Johnathan Mark Smith
  169.     2039 85 STREET
  170.     BROOKLYN, NY 11214
  171.  
  172.     Telephone: 718-373-3886
  173.  
  174.  
  175.  
  176.